home *** CD-ROM | disk | FTP | other *** search
/ Business Shareware / Business Shareware.iso / start / disk / pmi12 / pmi.doc next >
Text File  |  1993-02-25  |  13KB  |  267 lines
  1.                                    PMI
  2.  
  3.                           Personal Media Indexer
  4.  
  5.                   (c) 1993  Midwest T-Cubed, Tim Hoefer
  6.  
  7.      This program was created to make the author's life easy,
  8. simple, and basic.  He feels that this program may be needed and of
  9. use to fellow computer users also and hopes that others may
  10. benifit from it.  Please read the statement at the bottom of this
  11. doc file to see how registration of PMI can make you a few bucks.
  12. Following is a brief description of the program.
  13.  
  14. Requirements:
  15.      In order for PMI to find files in the subdirectories of the 
  16. diskette being indexed, you must have ver. 5.0 of MS-DOS or an
  17. equivalent.
  18.      All PMI files (PMI.EXE, PMIFIND.COM, and eventually PMI.NDX)
  19. should all be kept in the same directory.  In order for PMI to work
  20. effectively, it needs to know where these files are and it checks
  21. the environment variable 'PMI' to acquire the location.  To set the
  22. environment variable, type "SET PMI=" followed by the DRIVE AND
  23. PATH of the PMI files (i.e. C:\> set pmi=c:\utils\pmi).  This
  24. variable *must* be set before running PMI or an error will be given
  25. and the program will not execute.  This all may be accomplished by
  26. either adding the SET command to your autoexec.bat.  This is the
  27. most recommended way.  Writing a batchfile for executing PMI is not
  28. recommended, though, but if the user is knowledgable enough, these
  29. things need to be known:
  30.                
  31.                PMIFIND.COM is a compiled batch file and 
  32.             accepts either 0, 1, or 2 command-line arguments.
  33.  
  34. A batch file used to set the pmi env. var. and then execute
  35. PMIFIND.COM would have to be tailor fit to accept and pass 2
  36. arguments.
  37.  
  38. PMI.EXE:
  39.      This is the meat of the Personal Media Indexer system.  It is
  40. the program which is executed when the user wishes to index
  41. diskettes.  
  42.      After execution, the user is eventually prompted to enter the
  43. drive letter in which the first diskette will be read from.  Then
  44. the user is prompted to enter the diskette into this drive and
  45. press a key.  PMI reads all files in all directories of the drive.
  46. It then displays the files on the screen in red.  If any of the files
  47. are ARJ files or ARJ volumes (i.e. .A01, .A02, ...etc), they are listed
  48. in brown.  Note: The author keeps his archives only in ARJ format since
  49. the ARJ format has held up its reputation as the most efficient compres-
  50. sion format.  These ARJ file can be tagged or highlighted with the 
  51. spacebar.  They may be moved between with the '>' and '<' keys (shift
  52. need not be pressed).  By doing so, the user is telling PMI that these
  53. files should be indexed *with* their internal files also.  This comes
  54. in handy when an ARJ'd file consists of many independent files which
  55. may or may not have something to do with one another.
  56.     When the user is satisfied with the selections, the Enter key is
  57. pressed and PMI appends the diskette's and/or selected ARJ'd files' 
  58. contents into the PMI directory.  That's it, basic and simple.
  59.  
  60. Features of PMI.EXE:
  61.                 - in the upper right of the screen, a display shows
  62.                   which diskette was indexed last
  63.                 - in the upper left of the screen, a display shows
  64.                   the current diskette label and how many files were
  65.                   found on it
  66.                 - if a diskette does not have a label, the user is 
  67.                   asked if one should be assigned, if so, PMI prompts
  68.                   the user for a label name, if not, the user is 
  69.                   prompted to enter another diskette
  70.                   NOTE: PMI WILL NOT index a diskette if it does not
  71.                   have a label associated with it!
  72.                   NOTE: PMI will recognize duplicate disk labels and
  73.                   will prompt the user to continue if one is found
  74.  
  75. Problems of PMI.EXE:
  76.                 - PMI was written in Quick Basic and is not very
  77.                   powerful in the Disk Operating System department,
  78.                   I refused to use other programmers modules, in that
  79.                   I wanted to write PMI totally from scratch.  I am,
  80.                   for the most part satisfied, and up coming versions
  81.                   are to be written in Turbo Pascal.
  82.                 - In the above respect, Operating System error messages
  83.                   are directly echoed to the screen and no internal
  84.                   Disk Operating System error checking is done
  85.                 - PMI may be slow on older machines with slow disk
  86.                   access times.
  87.                 - PMI does not yet support other forms of file 
  88.                   compression, though it will in the future
  89.                 - PMI does not implement any deletion or replacement
  90.                   of disk listings (e.g. if a duplicate label is
  91.                   detected and the user wishes to proceed with 
  92.                   indexing, there will, then exist more than one
  93.                   listing for that label)
  94.  
  95. PMIFIND.COM:                
  96.    This is the utility which allows queries of the index file from the
  97. dos command line.  PMIfind's format follows
  98.   
  99.      PMIFIND [-c] [-l] [SEARCH STRING]
  100.  
  101.                 -c   turns on case-sensitive search 
  102.                      (upper and lower case specific)
  103.                 -l   lists the entire contents of the index file
  104.      
  105.      SEARCH STRING   the string to search on
  106.  
  107. This program is pretty easy to understand.  There are 3 main formats of
  108. PMIFIND.COM:
  109.  
  110.                 1. PMIFIND string
  111.                    - This searches the PMI.NDX file for all
  112.                      occurances of the letters s-t-r-i-n-g in
  113.                      succession.  Case is not taken into account,
  114.                      thus (String, STring, StRiNg, strIng, etc.)
  115.                      will all be considered a find.
  116.  
  117.                 2. PMIFIND -c string
  118.                    - This searches the PMI.NDX file for all
  119.                      occurances of the letters s-t-r-i-n-g in
  120.                      succesission.  Case IS taken into account,
  121.                      thus only 'string' will be considered a
  122.                      find
  123.  
  124.                 3. PMIFIND -l
  125.                    - This lists the entire contents of the PMI.NDX
  126.                      file.
  127.  
  128.     Keep in mind that when you index diskettes with the PMI program, it
  129. indexes volumes and internal ARJ files in all capital letters, while it
  130. indexes the filenames (ARJ and non-ARJ) in lowercase.  This aids in queries
  131. by allowing the user to designate -c with a lowercase string which will,
  132. in essense, restrict the search to only the original filenames.  This will
  133. also work vice versa using the -c switch and PMIfind.
  134.     The PMIfind output screen is nice in that it prints out a screen of
  135. finds and then prompts the user to press a key, then the next screen is
  136. displayed and so on until the end.  The files are displayed as they are
  137. found.
  138.  
  139.     I hope that this has sufficiently explained the workings of PMI.
  140. Basically it is a rather simple program, though, this surprises me since
  141. it took awhile to code.  (You wouldn't believe how many revisions
  142. I have made in this, added something here...removed something there...).
  143. In this respect, I feel that I have made a program which I find very
  144. useful.  If I have a hard drive failure, I have the PMI.NDX and the PMI
  145. program on disk with write-protect, and can go from there, restoring all
  146. of my programs and utilities.  Or, in the case that I just need a few
  147. utils every once in a while, I can put them on diskette, index them, and
  148. query on their whereabouts when I need them, use them, and delete them
  149. from my hard drive, thus freeing up space, and saving time.
  150.     I feel that this program would be of use to others and have decided    
  151. to release it as shareware, with a 30-day trial period.  This means that
  152. if, after 30 days of use, you find that you do not wish to register PMI
  153. (and possibly make a few dollars in return), you must delete all files
  154. which were received as the PMI program package AND all files created by
  155. the PMI program package.  But, before doing this, you have the right to
  156. pass the original PMI program, as you received it, to a fellow computer
  157. user.  Any deviation is a violation of the author's rights.
  158.     If you do wish to register PMI with the author, you will need to print
  159. the file REGISTER.FRM which should have been included with the PMI files (if
  160. one wasn't included, please print out and use the one below), fill it out 
  161. and follow these steps:
  162.                 
  163.                 1. copy down the serial number from the
  164.                    opening screen of PMI onto the registration
  165.                    form
  166.                 
  167.                 2. be sure to designate which diskette media
  168.                    you wish to receive
  169.                 
  170.                 3. make a check or money order of $15 out to
  171.                    TIM HOEFER 
  172.                 
  173.                 4. place the registration form and the check or
  174.                    money order in an envelope and send it to the
  175.                    address below
  176.  
  177.                            Midwest T-Cubed
  178.                            c/o Tim Hoefer
  179.                            1304 James Ave. N.E.
  180.                            Swisher, IA  52338-9801
  181.                                                U.S.A.
  182.  
  183.                 5. wait to receive YOUR PMI program which will
  184.                     contain YOUR serial number in it
  185.                 
  186.                 6. pass on the PMI files to friends, upload them
  187.                     to bulletin board systems, etc...
  188.                 
  189.                 7. await possible future payments of $5 for each
  190.                     person who registers a copy of YOUR PMI program
  191.                     with YOUR serial number
  192.  
  193.     Yes, if you register this copy of PMI, your $15 will buy you the latest
  194. version of PMI (which will contain a serial number linked to your name and
  195. address) on the disk size of your preference.  You may then copy your newly
  196. registered version of PMI and distribute it to bulletin board systems, your
  197. friends, or any place which accepts it.  This way, when people send in their
  198. registration fee and the serial number, I can find who was responsible for
  199. these people receiving their original copy of PMI and, thus can reward the 
  200. owner of the serial number by sending them $5.  So registering PMI can make
  201. you some extra money, and get you the latest version of PMI.  Think about it.
  202. Do you find PMI useful?  Does it save on headeaches?  Could you use a good   
  203. conscience-clearing?  If you answer yes to any of these, and find, that after
  204. 30 days of use, you still wish to use PMI....send in your registration form
  205. with your check or money order and possibly earn some money.  This will give
  206. the author insentive to continue writing programs.  Consider your registra-
  207. tion a vote.  NOTE: With registration, future versions of PMI may or may
  208. not be registered at a discount.  If a registrant fails to include a valid
  209. serial number or there lacks a serial number at all, the registrant will be
  210. notified and a request will be sent for re-submition of the serial number.
  211. Please be sure to copy it down correctly, this will ensure that the restrants
  212. before you may be rewarded as they deserve.  NOTE: The serial number is
  213. encoded and is tamper-proof.
  214.  
  215.     Bugs and comments may also be sent to the author via the Internet at this
  216. address: hoefer4739@iscsvax.uni.edu
  217.  
  218. -----------------------------------------------------------------------------
  219.  
  220. ARJ is a registered trademark of and copyrighted by Robert K. Jung.
  221.  
  222.  
  223.                             PMI v1.2
  224.                         Registration Form                         
  225.               (in the case REGISTER.FRM was missing) 
  226.  
  227.  
  228. NAME: -------------------- -------------- ----------------------
  229.           first                middle            last
  230.  
  231.  
  232. ADDRESS: ----------------- -------------------------------------
  233.           number                street
  234.  
  235.  
  236. ZIP: --------------------- -------------- ---------
  237.           city                  state        zip
  238.  
  239.  
  240.  
  241. MEDIA PREFERENCE:   [ ] 3.5"     SERIAL NUMBER: ___________________________
  242.                     [ ] 5.25"
  243.  
  244. Comments welcome: ---------------------------------------------------------
  245.  
  246. ---------------------------------------------------------------------------
  247.  
  248. ---------------------------------------------------------------------------
  249.  
  250. ---------------------------------------------------------------------------
  251.  
  252.  
  253.  
  254.  
  255.  
  256. Please send the 15 dollars in the form of a check or money order.
  257.  
  258.      I hereby state that the above information is correct.
  259.  
  260.  
  261.  
  262.                       ----------------    ----------------------------
  263.                            date                    signature
  264.  
  265.  
  266.                      
  267.